feat: add sequence operator types for event sequencing (A THEN B) by AustinFash · Pull Request #50 · mParticle/audience-sdk

AustinFash · 2026-03-09T15:51:05Z

Background

Composable Audiences currently support AND/OR-style combination of criteria but cannot express ordering constraints like "A happens, then B happens."
This blocks common funnel use cases (e.g., conversion funnels, activation steps).
This PR defines the TypeScript SDK types required to represent ordered event sequencing (A THEN B) in audience definitions, as specified in the
Composable Audience Event Sequencing Criteria v1 tech spec.

What Has Changed

sdk/typescript-schema/common/operator.ts: Added SequenceOperator type ("then") to represent the new sequence operator alongside existing
logical/binary/unary operators.
sdk/typescript-schema/operand/date-operand.ts: Added AliasPath type to reference a named step's field (e.g., { alias: "event1", path: "timestamp" }). Extended RelativeDate with optional relative_to?: AliasPath to allow Step B's recency window to be anchored relative to Step A's
timestamp rather than the evaluation timestamp.
sdk/typescript-schema/expression/expression.ts: Added SequenceOperand type (a single step with alias, operand: ModelPath, and optional
condition: Expression) and extended the Expression union type with a then variant ({ operator: SequenceOperator, sequence: SequenceOperand[] }).
sdk/typescript-schema/index.ts: Exported ModelPath from the public index (previously unexported, now required as SequenceOperand uses it as
a public type).

Screenshots/Video

N/A — type-only change.

Checklist

I have performed a self-review of my own code.
I have made corresponding changes to the documentation.
I have added tests that prove my fix is effective or that my feature works.
I have tested this locally.

Additional Notes

The sequence array on the then expression accepts any number of operands at the type level. V1 restricts sequences to exactly 2 steps (A THEN B),
but this constraint is enforced in the UI and validation layer — not in the type definition — so that expanding to N-step sequences in future only
requires a validation change, not a schema change.
The relative_to field on RelativeDate is optional and backward-compatible; existing audience definitions without sequencing are unaffected.
Downstream changes required in separate PRs: ingest-pipeline SQL generation, mPServer DTO/serialization (SequenceOperator.cs), and UI affordances.

Reference Issue (For employees only. Ignore if you are an outside contributor)

Closes https://go/j/COMP-2859

nathanachang-rokt · 2026-03-09T15:55:33Z

sdk/typescript-schema/expression/expression.ts

+ *      "condition": { "operator": "equal", "left": { "model": "events", "path": "name" }, "right": "purchase" }
+ *    }
+ */
+export type SequenceOperand = {


leave this in a separate file sequence-operand.ts and add it to the operand.ts type

mirazik18 · 2026-03-09T16:10:36Z

I believe we still need to update audience-definition-schema.json, audience_model.py, operator.ts, audience-schema.json, and update pyproject.toml.
Look at commits from cameron on how he did it: commit1, commit2

nathanachang-rokt · 2026-03-09T16:12:52Z

I believe we still need to update audience-definition-schema.json, audience_model.py, operator.ts, audience-schema.json, and update pyproject.toml. Look at commits from cameron on how he did it: commit1, commit2

I think you need to run one of the scripts to write a new schema version from the new .ts files. Start with the README and lmk if you need more help.

mirazik18 · 2026-03-09T16:29:57Z

sdk/typescript-schema/tsconfig.json

    "declarationDir": "dist",
-    "declarationMap": false
+    "declarationMap": false,
+    "emitDeclarationOnly": true


do we need it?

maybe a question for Oleg or a code reviewer with more context?

what was the reason for adding this?

olegk-rokt · 2026-03-10T14:21:03Z

sdk/python/mp_audience_sdk/models/audience_models.py

    operator: LogicalOperator


+class Expression1(BaseModel):


This needs to be properly named. I believe Kevin was using this to patch up code gen https://github.com/mParticle/audience-sdk/blob/main/sdk/typescript-schema/scripts/add_titles_to_schema.sh

@AustinFash add
$.definitions.Expression.anyOf[3]|SequenceExpression to that file after line 24

olegk-rokt · 2026-03-10T16:30:29Z

sdk/typescript-schema/operand/date-operand.ts

+ * 1. Reference event1's timestamp:
+ *    { alias: "event1", path: "timestamp" }
+ */
+export type AliasPath = {


does it only apply to dates? Reads like it shouldn't be in this file

No, this applies to any generic "alias" but we are using it only for the Event Sequencing use case as of now. We are defining an alias as a CTE to represent a qualified Event (qualified Event meaning the Event data model and any other conditions that specify which Events qualify). Then the path from that alias would be QualifiedEvent.Path (modeled after ModelPath)

lets move it to the appropriate file where the model path defined

# [1.5.0](https://github.com/mParticle/audience-sdk/compare/audience-typescript-schema@1.4.2...audience-typescript-schema@1.5.0) (2026-03-10) ### Features * add sequence operator types for event sequencing (A THEN B) ([#50](#50)) ([cebde5a](cebde5a))

mparticle-automation · 2026-03-10T16:40:46Z

🎉 This PR is included in version 1.5.0 🎉

The release is available on:

audience-typescript-schema@1.5.0
GitHub release

Your semantic-release bot 📦🚀

add then to audience sdk

b06240d

nathanachang-rokt reviewed Mar 9, 2026

View reviewed changes

nathanachang-rokt approved these changes Mar 9, 2026

View reviewed changes

fix pr

326aa55

more changes

e48399d

mirazik18 reviewed Mar 9, 2026

View reviewed changes

nathanachang-rokt previously approved these changes Mar 9, 2026

View reviewed changes

update toml

0a2ad52

olegk-rokt requested changes Mar 10, 2026

View reviewed changes

fix naming

2387cae

AustinFash dismissed nathanachang-rokt’s stale review via 2387cae March 10, 2026 15:56

olegk-rokt reviewed Mar 10, 2026

View reviewed changes

olegk-rokt approved these changes Mar 10, 2026

View reviewed changes

AustinFash merged commit cebde5a into main Mar 10, 2026
1 check passed

AustinFash deleted the COMP-2859-define-new-audience-sdk-type-script-types-for-sequencing branch March 10, 2026 16:38

mparticle-automation added the released label Mar 10, 2026

Conversation

AustinFash commented Mar 9, 2026

Background

What Has Changed

Screenshots/Video

Checklist

Additional Notes

Reference Issue (For employees only. Ignore if you are an outside contributor)

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mirazik18 commented Mar 9, 2026

Uh oh!

nathanachang-rokt commented Mar 9, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

olegk-rokt Mar 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

mparticle-automation commented Mar 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

olegk-rokt Mar 10, 2026 •

edited

Loading